Mailspring/internal_packages/composer/lib/participants-text-field.cjsx
Ben Gotow 1dc7c03ebd fix(contact-chips): Contact chips are editable and have much better style
Summary:
The TokenizingTextField has several new optional props, including onEdit, which enables
editing of the tokens and tokenIsInvalid, which allows you to make tokens red, while still
accepting them as tokens.

When you go to send a message with invalid recipients it won't let you until you remove/
edit them.

Hotloading

Edit chips, keymappings not through command registry, 7 new tests for editing chips

Test Plan: Run 7 new tests

Reviewers: evan

Reviewed By: evan

Differential Revision: https://phab.nylas.com/D1825
2015-08-03 13:06:28 -07:00

163 lines
5.4 KiB
CoffeeScript

React = require 'react'
_ = require 'underscore'
{Utils, Contact, ContactStore} = require 'nylas-exports'
{TokenizingTextField, Menu} = require 'nylas-component-kit'
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,
# 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
shouldComponentUpdate: (nextProps, nextState) =>
not Utils.isEqualReact(nextProps, @props) or
not Utils.isEqualReact(nextState, @state)
render: =>
classSet = {}
classSet[@props.field] = true
<div className="participants-text-field" style={zIndex: 1000-@props.tabIndex, display: 'inline'}>
<TokenizingTextField
ref="textField"
tokens={@props.participants[@props.field]}
tokenKey={ (p) -> p.email }
tokenIsValid={ (p) -> ContactStore.isValidContact(p) }
tokenNode={@_tokenNode}
onRequestCompletions={ (input) -> ContactStore.searchContacts(input) }
completionNode={@_completionNode}
onAdd={@_add}
onRemove={@_remove}
onEdit={@_edit}
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>
_tokensForString: (string, options = {}) =>
# 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 string.length is 0
return []
contacts = ContactStore.parseContactsInString(string, options)
if contacts.length > 0
return contacts
else
# If no contacts are returned, treat the entire string as a single
# (malformed) contact object.
return [new Contact(email: string, name: null)]
_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)
_edit: (token, replacementString) =>
field = @props.field
tokenIndex = @props.participants[field].indexOf(token)
replacements = @_tokensForString(replacementString)
updates = {}
updates[field] = [].concat(@props.participants[field])
updates[field].splice(tokenIndex, 1, replacements...)
@props.change(updates)
_add: (values, options={}) =>
# 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)
values = @_tokensForString(values, options)
# Safety check: remove anything from the incoming values that isn't
# a Contact. We should never receive anything else in the values array.
values = _.filter values, (value) -> value instanceof Contact
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