Mailspring/internal_packages/composer/lib/participants-text-field.cjsx
Ben Gotow 9ffe0d74dd feat(unsafe-components): Wrap injected components, catch exceptions, clean up ComponentRegistry
Summary:
This diff gives the ComponentRegistry a cleaner, smaller API. Instead of querying by name, location or role,
it's now just location and role, and you can register components for one or more location and one or more
roles without assigning the entries in the registry separate names.

When you register with the ComponentRegistry, the syntax is also cleaner and uses the component's displayName
instead of requiring you to provide a name. You also provide the actual component when unregistering, ensuring
that you can't unregister someone else's component.

InjectedComponent and InjectedComponentSet now wrap their children in UnsafeComponent, which prevents
render/component lifecycle problems from propogating.

Existing components have been updated:

1. maxWidth / minWidth are now containerStyles.maxWidth/minWidth
2. displayName is now required to use the CR.
3. containerRequired = false can be provided to exempt a component from being wrapped in an UnsafeComponent.
   This is useful because it's slightly faster and keeps DOM flat.

This diff also makes the "Show Component Regions" more awesome. It displays column regions, since they now
use the InjectedComponentSet, and also shows for InjectedComponent as well as InjectedComponentSet.

Change ComponentRegistry syntax, lots more work on safely wrapping items. See description.

Fix for inline flexbox scenarios (message actions)

Allow ~/.inbox/packages to be symlinked to a github repo

Test Plan: Run tests!

Reviewers: evan

Reviewed By: evan

Differential Revision: https://review.inboxapp.com/D1457
2015-04-30 16:10:15 -07:00

169 lines
5.4 KiB
CoffeeScript

React = require 'react'
_ = require 'underscore-plus'
{Contact,
Utils,
ContactStore} = require 'inbox-exports'
{TokenizingTextField, Menu} = require 'ui-components'
class ParticipantsTextField extends React.Component
@displayName: 'ParticipantsTextField'
@propTypes:
# The tab index of the ParticipantsTextField
tabIndex: React.PropTypes.string,
# The name of the field, used for both display purposes and also
# to modify the `participants` provided.
field: React.PropTypes.string,
# Whether or not the field should be visible. Defaults to true.
visible: React.PropTypes.bool
# An object containing arrays of participants. Typically, this is
# {to: [], cc: [], bcc: []}. Each ParticipantsTextField needs all of
# the values, because adding an element to one field may remove it
# from another.
participants: React.PropTypes.object.isRequired,
# The function to call with an updated `participants` object when
# changes are made.
change: React.PropTypes.func.isRequired,
@defaultProps:
visible: true
render: =>
classSet = {}
classSet[@props.field] = true
<div className="participants-text-field" style={zIndex: 1000-@props.tabIndex, display: @props.visible and 'inline' or 'none'}>
<TokenizingTextField
ref="textField"
tokens={@props.participants[@props.field]}
tokenKey={ (p) -> p.email }
tokenNode={@_tokenNode}
onRequestCompletions={ (input) -> ContactStore.searchContacts(input) }
completionNode={@_completionNode}
onAdd={@_add}
onRemove={@_remove}
onEmptied={@props.onEmptied}
onTokenAction={@_showContextMenu}
tabIndex={@props.tabIndex}
menuClassSet={classSet}
menuPrompt={@props.field}
/>
</div>
# Public. Can be called by any component that has a ref to this one to
# focus the input field.
focus: => @refs.textField.focus()
_completionNode: (p) =>
<Menu.NameEmailItem name={p.name} email={p.email} />
_tokenNode: (p) =>
if p.name?.length > 0 and p.name isnt p.email
<div className="participant">
<span className="participant-primary">{p.name}</span>&nbsp;&nbsp;
<span className="participant-secondary">({p.email})</span>
</div>
else
<div className="participant">
<span className="participant-primary">{p.email}</span>
</div>
_remove: (values) =>
field = @props.field
updates = {}
updates[field] = _.reject @props.participants[field], (p) ->
return true if p.email in values
return true if p.email in _.map values, (o) -> o.email
false
@props.change(updates)
_add: (values) =>
# If the input is a string, parse out email addresses and build
# an array of contact objects. For each email address wrapped in
# parentheses, look for a preceding name, if one exists.
if _.isString(values)
detected = []
while (match = Utils.emailRegex.exec(values))
email = match[0]
name = null
hasLeadingParen = values[match.index-1] in ['(','<']
hasTrailingParen = values[match.index+email.length] in [')','>']
if hasLeadingParen and hasTrailingParen
nameStart = 0
for char in ['>', ')', ',', '\n', '\r']
i = values.lastIndexOf(char, match.index)
nameStart = i+1 if i+1 > nameStart
name = values.substr(nameStart, match.index - 1 - nameStart).trim()
if not name or name.length is 0
# Look to see if we can find a name for this email address in the ContactStore.
# Otherwise, just populate the name with the email address.
existing = ContactStore.searchContacts(email, {limit:1})[0]
if existing and existing.name
name = existing.name
else
name = email
detected.push(new Contact({email, name}))
values = detected
# Safety check: remove anything from the incoming values that isn't
# a Contact. We should never receive anything else in the values array.
values = _.compact _.map values, (value) ->
if value instanceof Contact
return value
else
return null
updates = {}
for field in Object.keys(@props.participants)
updates[field] = [].concat(@props.participants[field])
for value in values
# first remove the participant from all the fields. This ensures
# that drag and drop isn't "drag and copy." and you can't have the
# same recipient in multiple places.
for field in Object.keys(@props.participants)
updates[field] = _.reject updates[field], (p) ->
p.email is value.email
# add the participant to field
updates[@props.field] = _.union(updates[@props.field], [value])
@props.change(updates)
""
_showContextMenu: (participant) =>
remote = require('remote')
# Warning: Menu is already initialized as Menu.cjsx!
MenuClass = remote.require('menu')
MenuItem = remote.require('menu-item')
menu = new MenuClass()
menu.append(new MenuItem(
label: "Copy #{participant.email}"
click: => require('clipboard').writeText(participant.email)
))
menu.append(new MenuItem(
type: 'separator'
))
menu.append(new MenuItem(
label: 'Remove',
click: => @_remove([participant])
))
menu.popup(remote.getCurrentWindow())
module.exports = ParticipantsTextField