app/frontend/apps/mobile/components/Form/fields/FieldTreeSelect/__tests__/FieldTreeSelect.spec.ts
// Copyright (C) 2012-2024 Zammad Foundation, https://zammad-foundation.org/
import { cloneDeep, keyBy } from 'lodash-es'
import { getByText, waitFor } from '@testing-library/vue'
import { FormKit } from '@formkit/vue'
import { renderComponent } from '#tests/support/components/index.ts'
import { i18n } from '#shared/i18n.ts'
import { getNode } from '@formkit/core'
import { useLocaleStore } from '#shared/stores/locale.ts'
import { EnumTextDirection } from '#shared/graphql/types.ts'
const testOptions = [
{
value: 0,
label: 'Item A',
children: [
{
value: 1,
label: 'Item 1',
children: [
{
value: 2,
label: 'Item I',
},
{
value: 3,
label: 'Item II',
},
{
value: 4,
label: 'Item III',
},
],
},
{
value: 5,
label: 'Item 2',
children: [
{
value: 6,
label: 'Item IV',
},
],
},
{
value: 7,
label: 'Item 3',
},
],
},
{
value: 8,
label: 'Item B',
},
{
value: 9,
label: 'Ítem C',
},
]
const wrapperParameters = {
form: true,
formField: true,
store: true,
dialog: true,
}
beforeAll(async () => {
// so we don't need to wait until it loads inside test
await import('../FieldTreeSelectInputDialog.vue')
})
describe('Form - Field - TreeSelect - Dialog', () => {
it('renders select options in a modal dialog', async () => {
const wrapper = renderComponent(FormKit, {
...wrapperParameters,
props: {
label: 'Select…',
type: 'treeselect',
options: testOptions,
},
})
await wrapper.events.click(wrapper.getByLabelText('Select…'))
const selectOptions = wrapper.getAllByRole('option')
expect(selectOptions).toHaveLength(testOptions.length)
selectOptions.forEach((selectOption, index) => {
expect(selectOption).toHaveTextContent(testOptions[index].label)
})
await wrapper.events.click(wrapper.getByRole('button', { name: /Done/ }))
expect(wrapper.queryByRole('dialog')).not.toBeInTheDocument()
})
it('sets value on selection and closes the dialog', async () => {
const wrapper = renderComponent(FormKit, {
...wrapperParameters,
props: {
label: 'Select…',
type: 'treeselect',
options: testOptions,
clearable: true,
},
})
await wrapper.events.click(wrapper.getByLabelText('Select…'))
wrapper.events.click(wrapper.getAllByRole('option')[0])
await waitFor(() => {
expect(wrapper.emitted().inputRaw).toBeTruthy()
})
const emittedInput = wrapper.emitted().inputRaw as Array<Array<InputEvent>>
expect(emittedInput[0][0]).toBe(testOptions[0].value)
expect(wrapper.queryByRole('dialog')).not.toBeInTheDocument()
})
it('renders selected option in semibold text with a check mark icon', async () => {
const wrapper = renderComponent(FormKit, {
...wrapperParameters,
props: {
label: 'Select…',
type: 'treeselect',
options: testOptions,
value: testOptions[1].value,
},
})
await wrapper.events.click(wrapper.getByLabelText('Select…'))
expect(
getByText(wrapper.getByRole('listbox'), testOptions[1].label),
).toHaveClass('font-semibold')
expect(wrapper.getByIconName('check')).toBeInTheDocument()
await wrapper.events.click(wrapper.getByRole('button', { name: /Done/ }))
expect(wrapper.queryByRole('dialog')).not.toBeInTheDocument()
})
it('shows full path of selected options', async () => {
const wrapper = renderComponent(FormKit, {
...wrapperParameters,
props: {
type: 'treeselect',
options: testOptions,
value: testOptions[0].children![0].children![0].value,
},
})
const selectedLabel = wrapper.getByRole('listitem')
expect(selectedLabel).toHaveTextContent(
`${testOptions[0].label} \u203A ${
testOptions[0].children![0].label
} \u203A ${testOptions[0].children![0].children![0].label}`,
)
})
it('supports tree paging', async () => {
const wrapper = renderComponent(FormKit, {
...wrapperParameters,
props: {
label: 'Select…',
type: 'treeselect',
options: testOptions,
},
})
// Level 0
await wrapper.events.click(wrapper.getByLabelText('Select…'))
// only "Done"
expect(wrapper.getAllByRole('button')).toHaveLength(1)
let selectOptions = wrapper.getAllByRole('option')
expect(selectOptions).toHaveLength(testOptions.length)
selectOptions.forEach((selectOption, index) => {
expect(selectOption).toHaveTextContent(testOptions[index].label)
})
// Level 1
await wrapper.events.click(wrapper.getAllByRole('link')[0])
expect(wrapper.getAllByRole('button')[1]).toHaveTextContent(
testOptions[0].label,
)
selectOptions = wrapper.getAllByRole('option')
expect(selectOptions).toHaveLength(testOptions[0].children!.length)
selectOptions.forEach((selectOption, index) => {
expect(selectOption).toHaveTextContent(
testOptions[0].children![index].label,
)
})
// Level 2
await wrapper.events.click(wrapper.getAllByRole('link')[0])
expect(wrapper.getAllByRole('button')[1]).toHaveTextContent(
testOptions[0].children![0].label,
)
expect(wrapper.getAllByRole('button')).toHaveLength(2)
selectOptions = wrapper.getAllByRole('option')
expect(selectOptions).toHaveLength(
testOptions[0].children![0].children!.length,
)
selectOptions.forEach((selectOption, index) => {
expect(selectOption).toHaveTextContent(
testOptions[0].children![0].children![index].label,
)
})
// Level 1
await wrapper.events.click(wrapper.getAllByRole('button')[1])
expect(wrapper.getAllByRole('button')[1]).toHaveTextContent(
testOptions[0].label,
)
selectOptions = wrapper.getAllByRole('option')
expect(selectOptions).toHaveLength(testOptions[0].children!.length)
selectOptions.forEach((selectOption, index) => {
expect(selectOption).toHaveTextContent(
testOptions[0].children![index].label,
)
})
// Level 2
await wrapper.events.click(wrapper.getAllByRole('link')[1])
expect(wrapper.getAllByRole('button')[1]).toHaveTextContent(
testOptions[0].children![1].label,
)
selectOptions = wrapper.getAllByRole('option')
expect(selectOptions).toHaveLength(
testOptions[0].children![1].children!.length,
)
selectOptions.forEach((selectOption, index) => {
expect(selectOption).toHaveTextContent(
testOptions[0].children![1].children![index].label,
)
})
await wrapper.events.click(wrapper.getAllByRole('button')[0])
// Level 0
await wrapper.events.click(wrapper.getByLabelText('Select…'))
expect(wrapper.getAllByRole('button')).toHaveLength(1)
selectOptions = wrapper.getAllByRole('option')
expect(selectOptions).toHaveLength(testOptions.length)
selectOptions.forEach((selectOption, index) => {
expect(selectOption).toHaveTextContent(testOptions[index].label)
})
})
})
describe('Form - Field - TreeSelect - Options', () => {
it('supports unknown options', async () => {
const optionsProp = cloneDeep(testOptions)
const wrapper = renderComponent(FormKit, {
...wrapperParameters,
props: {
label: 'Select…',
type: 'treeselect',
value: 10,
options: optionsProp,
},
})
expect(wrapper.getByRole('listitem')).toHaveTextContent('10 (unknown)')
await wrapper.events.click(wrapper.getByLabelText('Select…'))
let selectOptions = wrapper.getAllByRole('option')
expect(selectOptions).toHaveLength(optionsProp.length)
selectOptions.forEach((selectOption, index) => {
expect(selectOption).toHaveTextContent(testOptions[index].label)
})
optionsProp.push({
value: 10,
label: 'Item D',
})
await wrapper.rerender({
options: optionsProp,
})
selectOptions = wrapper.getAllByRole('option')
expect(selectOptions).toHaveLength(optionsProp.length)
await wrapper.events.click(wrapper.getByRole('button'))
expect(wrapper.getByRole('listitem')).toHaveTextContent('Item D')
})
it('supports clearing of the existing value when option goes away', async () => {
const optionsProp = cloneDeep(testOptions)
optionsProp.push({
value: 10,
label: 'Item D',
})
const wrapper = renderComponent(FormKit, {
...wrapperParameters,
props: {
clearable: true, // otherwise it defaults to the first option
type: 'treeselect',
value: 10,
options: optionsProp,
},
})
expect(wrapper.getByRole('listitem')).toHaveTextContent('Item D')
optionsProp.pop()
await wrapper.rerender({
options: optionsProp,
})
await waitFor(() => {
expect(wrapper.emitted().inputRaw).toBeTruthy()
})
const emittedInput = wrapper.emitted().inputRaw as Array<Array<InputEvent>>
expect(emittedInput[0][0]).toBe(null)
expect(wrapper.queryByRole('listitem')).not.toBeInTheDocument()
})
it('supports historical options', async () => {
const wrapper = renderComponent(FormKit, {
...wrapperParameters,
props: {
label: 'Select…',
type: 'treeselect',
value: 10,
options: testOptions,
historicalOptions: {
...keyBy(testOptions, 'value'),
10: 'Item D',
},
},
})
expect(wrapper.getByRole('listitem')).toHaveTextContent('Item D')
await wrapper.events.click(wrapper.getByLabelText('Select…'))
let selectOptions = wrapper.getAllByRole('option')
expect(selectOptions).toHaveLength(4)
selectOptions.forEach((selectOption, index) => {
if (index === 3) expect(selectOption).toHaveTextContent('Item D')
else expect(selectOption).toHaveTextContent(testOptions[index].label)
})
await wrapper.events.click(selectOptions[0])
await waitFor(() => {
expect(wrapper.emitted().inputRaw).toBeTruthy()
})
const emittedInput = wrapper.emitted().inputRaw as Array<Array<InputEvent>>
expect(emittedInput[0][0]).toBe(testOptions[0].value)
expect(wrapper.getByRole('listitem')).toHaveTextContent(
testOptions[0].label,
)
await wrapper.events.click(wrapper.getByLabelText('Select…'))
selectOptions = wrapper.getAllByRole('option')
expect(selectOptions).toHaveLength(4)
selectOptions.forEach((selectOption, index) => {
if (index === 3) expect(selectOption).toHaveTextContent('Item D')
else expect(selectOption).toHaveTextContent(testOptions[index].label)
})
})
it('supports rejection of non-existent values', async () => {
const wrapper = renderComponent(FormKit, {
...wrapperParameters,
props: {
label: 'Select…',
type: 'treeselect',
value: 10,
options: testOptions,
clearable: true, // otherwise it defaults to the first option
rejectNonExistentValues: true,
},
})
await waitFor(() => {
expect(wrapper.emitted().inputRaw).toBeTruthy()
})
const emittedInput = wrapper.emitted().inputRaw as Array<Array<InputEvent>>
expect(emittedInput[0][0]).toBe(null)
expect(wrapper.queryByRole('listitem')).not.toBeInTheDocument()
await wrapper.events.click(wrapper.getByLabelText('Select…'))
const selectOptions = wrapper.getAllByRole('option')
expect(selectOptions).toHaveLength(3)
})
it('supports disabled property', async () => {
const disabledOptions = [
{
value: 0,
label: 'Item A',
},
{
value: 1,
label: 'Item B',
disabled: true,
children: [
{
value: 3,
label: 'Item 1',
},
{
value: 4,
label: 'Item 2',
},
],
},
{
value: 2,
label: 'Item C',
},
]
const wrapper = renderComponent(FormKit, {
...wrapperParameters,
props: {
label: 'Select…',
type: 'treeselect',
options: disabledOptions,
},
})
await wrapper.events.click(wrapper.getByLabelText('Select…'))
expect(wrapper.getAllByRole('option')[1]).toHaveClass('pointer-events-none')
expect(
getByText(wrapper.getByRole('listbox'), disabledOptions[1].label),
).toHaveClass('opacity-30')
await wrapper.events.click(wrapper.getByRole('link'))
const selectOptions = wrapper.getAllByRole('option')
expect(selectOptions).toHaveLength(disabledOptions[1].children!.length)
selectOptions.forEach((selectOption, index) => {
expect(selectOption).toHaveTextContent(
disabledOptions[1].children![index].label,
)
})
})
it('supports status property', async () => {
const statusOptions = [
{
value: 'open',
label: 'Open',
status: 'open',
},
{
value: 'closed',
label: 'Closed',
status: 'closed',
},
{
value: 'waiting-for-reminder',
label: 'Waiting for closure',
status: 'waiting-for-reminder',
},
{
value: 'waiting-for-closure',
label: 'Waiting for reminder',
status: 'waiting-for-closure',
},
{
value: 'escalated',
label: 'Escalated',
status: 'escalated',
},
]
const wrapper = renderComponent(FormKit, {
...wrapperParameters,
props: {
label: 'Select…',
type: 'treeselect',
options: statusOptions,
},
})
await wrapper.events.click(wrapper.getByLabelText('Select…'))
const selectOptions = wrapper.getAllByRole('option')
const selectedOptionStatuses = wrapper.getAllByRole('group')
expect(selectOptions).toHaveLength(selectedOptionStatuses.length)
await wrapper.events.click(selectOptions[0])
expect(wrapper.getByRole('listitem')).toHaveAttribute(
'data-test-status',
statusOptions[0].status,
)
})
it('supports icon property', async () => {
const iconOptions = [
{
value: 1,
label: 'GitLab',
icon: 'gitlab',
},
{
value: 2,
label: 'GitHub',
icon: 'github',
},
]
const wrapper = renderComponent(FormKit, {
...wrapperParameters,
props: {
label: 'Select…',
type: 'treeselect',
options: iconOptions,
clearable: true,
},
})
await wrapper.events.click(wrapper.getByLabelText('Select…'))
expect(wrapper.queryByIconName(iconOptions[0].icon)).toBeInTheDocument()
expect(wrapper.queryByIconName(iconOptions[1].icon)).toBeInTheDocument()
})
})
describe('Form - Field - TreeSelect - Features', () => {
// FIXME: Updating value prop does not seem to mutate it.
// It could be a bug in FormKit, though. Retry with next release.
it.todo('supports value mutation', async () => {
const wrapper = renderComponent(FormKit, {
...wrapperParameters,
props: {
type: 'treeselect',
options: testOptions,
value: testOptions[1].value,
},
})
expect(wrapper.getByRole('listitem')).toHaveTextContent(
testOptions[1].label,
)
await wrapper.rerender({
value: testOptions[2].value,
})
expect(wrapper.getByRole('listitem')).toHaveTextContent(
testOptions[2].label,
)
})
it('supports selection clearing', async () => {
const wrapper = renderComponent(FormKit, {
...wrapperParameters,
props: {
type: 'treeselect',
options: testOptions,
value: testOptions[1].value,
clearable: true,
},
})
expect(wrapper.getByRole('listitem')).toHaveTextContent(
testOptions[1].label,
)
await wrapper.events.click(wrapper.getByRole('button'))
await waitFor(() => {
expect(wrapper.emitted().inputRaw).toBeTruthy()
})
const emittedInput = wrapper.emitted().inputRaw as Array<Array<InputEvent>>
expect(emittedInput[0][0]).toBe(null)
expect(wrapper.queryByRole('listitem')).not.toBeInTheDocument()
expect(wrapper.queryByRole('button')).not.toBeInTheDocument()
})
it('supports multiple selection', async () => {
const wrapper = renderComponent(FormKit, {
...wrapperParameters,
props: {
label: 'Select…',
type: 'treeselect',
options: testOptions,
multiple: true,
},
})
await wrapper.events.click(wrapper.getByLabelText('Select…'))
const selectOptions = wrapper.getAllByRole('option')
expect(selectOptions).toHaveLength(
wrapper.queryAllByIconName('check-box-no').length,
)
wrapper.events.click(selectOptions[0])
await waitFor(() => {
expect(wrapper.emitted().inputRaw).toBeTruthy()
})
const emittedInput = wrapper.emitted().inputRaw as Array<Array<InputEvent>>
expect(emittedInput[0][0]).toStrictEqual([testOptions[0].value])
expect(wrapper.queryAllByIconName('check-box-no')).toHaveLength(2)
expect(wrapper.queryAllByIconName('check-box-yes')).toHaveLength(1)
expect(wrapper.queryByRole('dialog')).toBeInTheDocument()
expect(wrapper.queryAllByRole('listitem')).toHaveLength(1)
wrapper.queryAllByRole('listitem').forEach((selectedLabel, index) => {
expect(selectedLabel).toHaveTextContent(testOptions[index].label)
})
wrapper.events.click(selectOptions[1])
await waitFor(() => {
expect(emittedInput[1][0]).toStrictEqual([
testOptions[0].value,
testOptions[1].value,
])
})
expect(wrapper.queryAllByIconName('check-box-no')).toHaveLength(1)
expect(wrapper.queryAllByIconName('check-box-yes')).toHaveLength(2)
expect(wrapper.queryByRole('dialog')).toBeInTheDocument()
expect(wrapper.queryAllByRole('listitem')).toHaveLength(2)
wrapper.queryAllByRole('listitem').forEach((selectedLabel, index) => {
expect(selectedLabel).toHaveTextContent(testOptions[index].label)
})
wrapper.events.click(selectOptions[2])
await waitFor(() => {
expect(emittedInput[2][0]).toStrictEqual([
testOptions[0].value,
testOptions[1].value,
testOptions[2].value,
])
})
expect(wrapper.queryAllByIconName('check-box-no')).toHaveLength(0)
expect(wrapper.queryAllByIconName('check-box-yes')).toHaveLength(3)
expect(wrapper.queryByRole('dialog')).toBeInTheDocument()
expect(wrapper.queryAllByRole('listitem')).toHaveLength(3)
wrapper.queryAllByRole('listitem').forEach((selectedLabel, index) => {
expect(selectedLabel).toHaveTextContent(testOptions[index].label)
})
wrapper.events.click(selectOptions[2])
await waitFor(() => {
expect(emittedInput[3][0]).toStrictEqual([
testOptions[0].value,
testOptions[1].value,
])
})
expect(wrapper.queryAllByIconName('check-box-no')).toHaveLength(1)
expect(wrapper.queryAllByIconName('check-box-yes')).toHaveLength(2)
expect(wrapper.queryByRole('dialog')).toBeInTheDocument()
expect(wrapper.queryAllByRole('listitem')).toHaveLength(2)
wrapper.queryAllByRole('listitem').forEach((selectedLabel, index) => {
expect(selectedLabel).toHaveTextContent(testOptions[index].label)
})
await wrapper.events.click(wrapper.getByRole('button'))
})
it('supports option sorting', async (context) => {
context.skipConsole = true
const reversedOptions = cloneDeep(testOptions).reverse()
const wrapper = renderComponent(FormKit, {
...wrapperParameters,
props: {
label: 'Select…',
type: 'treeselect',
options: reversedOptions,
sorting: 'label',
},
})
await wrapper.events.click(wrapper.getByLabelText('Select…'))
let selectOptions = wrapper.getAllByRole('option')
selectOptions.forEach((selectOption, index) => {
expect(selectOption).toHaveTextContent(testOptions[index].label)
})
await wrapper.rerender({
sorting: 'value',
})
selectOptions = wrapper.getAllByRole('option')
selectOptions.forEach((selectOption, index) => {
expect(selectOption).toHaveTextContent(testOptions[index].label)
})
vi.spyOn(console, 'warn')
await wrapper.rerender({
sorting: 'foobar',
})
expect(console.warn).toHaveBeenCalledWith(
'Unsupported sorting option "foobar"',
)
})
it('supports label translation', async () => {
const untranslatedOptions = [
{
value: 0,
label: 'Item A (%s)',
labelPlaceholder: [0],
},
{
value: 1,
label: 'Item B (%s)',
labelPlaceholder: [1],
},
{
value: 2,
label: 'Item C (%s)',
labelPlaceholder: [2],
},
]
const translatedOptions = untranslatedOptions.map((untranslatedOption) => ({
...untranslatedOption,
label: i18n.t(
untranslatedOption.label,
untranslatedOption.labelPlaceholder as never,
),
}))
const wrapper = renderComponent(FormKit, {
...wrapperParameters,
props: {
label: 'Select…',
type: 'treeselect',
options: untranslatedOptions,
},
})
await wrapper.events.click(wrapper.getByLabelText('Select…'))
let selectOptions = await wrapper.findAllByRole('option')
selectOptions.forEach((selectOption, index) => {
expect(selectOption).toHaveTextContent(translatedOptions[index].label)
})
await wrapper.events.click(selectOptions[0])
expect(wrapper.getByRole('listitem')).toHaveTextContent(
translatedOptions[0].label,
)
await wrapper.rerender({
noOptionsLabelTranslation: true,
})
await wrapper.events.click(wrapper.getByLabelText('Select…'))
selectOptions = await wrapper.findAllByRole('option')
selectOptions.forEach((selectOption, index) => {
expect(selectOption).toHaveTextContent(untranslatedOptions[index].label)
})
await wrapper.events.click(selectOptions[1])
expect(wrapper.getByRole('listitem')).toHaveTextContent(
untranslatedOptions[1].label,
)
})
it('supports option preselect', async () => {
const wrapper = renderComponent(FormKit, {
...wrapperParameters,
props: {
label: 'Select…',
name: 'treeselect',
id: 'treeselect',
type: 'treeselect',
options: testOptions,
},
})
await waitFor(() => {
expect(wrapper.emitted().inputRaw).toBeTruthy()
})
expect(wrapper.getByRole('listitem')).toHaveTextContent('Item A')
await wrapper.rerender({
clearable: true,
})
await wrapper.events.click(wrapper.getByRole('button'))
await waitFor(() => {
expect(wrapper.emitted().inputRaw).toBeTruthy()
})
expect(wrapper.queryByRole('listitem')).not.toBeInTheDocument()
await wrapper.rerender({
clearable: false,
})
await waitFor(() => {
expect(wrapper.emitted().inputRaw).toBeTruthy()
})
expect(wrapper.getByRole('listitem')).toHaveTextContent('Item A')
// Reset the value before the next test case
const node = getNode('treeselect')
node?.input(null)
await wrapper.rerender({
clearable: false,
options: [
{
value: 9,
label: 'Ítem C',
},
],
})
await waitFor(() => {
expect(wrapper.emitted().inputRaw).toBeTruthy()
})
expect(wrapper.getByRole('listitem')).toHaveTextContent('Ítem C')
await wrapper.rerender({
clearable: true,
multiple: true,
})
await wrapper.events.click(wrapper.getByRole('button'))
await waitFor(() => {
expect(wrapper.emitted().inputRaw).toBeTruthy()
})
expect(wrapper.queryByRole('listitem')).not.toBeInTheDocument()
await wrapper.rerender({
clearable: false,
})
expect(wrapper.queryByRole('listitem')).not.toBeInTheDocument()
await wrapper.rerender({
clearable: true,
multiple: false,
disabled: true,
})
expect(wrapper.queryByRole('listitem')).not.toBeInTheDocument()
await wrapper.rerender({
clearable: false,
})
expect(wrapper.queryByRole('listitem')).not.toBeInTheDocument()
})
it('considers only enabled options for preselection', async () => {
const disabledOptions = [
{
value: 0,
label: 'Item A',
disabled: true,
},
{
value: 1,
label: 'Item B',
disabled: true,
children: [
{
value: 3,
label: 'Item 1',
},
{
value: 4,
label: 'Item 2',
},
],
},
{
value: 2,
label: 'Item C',
},
]
const wrapper = renderComponent(FormKit, {
...wrapperParameters,
props: {
name: 'treeselect',
id: 'treeselect',
type: 'treeselect',
options: disabledOptions,
},
})
await waitFor(() => {
expect(wrapper.emitted().inputRaw).toBeTruthy()
})
expect(wrapper.getByRole('listitem')).toHaveTextContent('Item 1')
})
it('supports option filtering', async () => {
const wrapper = renderComponent(FormKit, {
...wrapperParameters,
props: {
label: 'Select…',
type: 'treeselect',
options: testOptions,
},
})
await wrapper.events.click(wrapper.getByLabelText('Select…'))
const filterElement = wrapper.getByRole('searchbox')
expect(filterElement).toBeInTheDocument()
let selectOptions = wrapper.getAllByRole('option')
expect(selectOptions).toHaveLength(3)
// Without parent filtering, search happens across all options, even nested ones.
// Search is always case-insensitive.
await wrapper.events.type(filterElement, 'iv')
selectOptions = wrapper.getAllByRole('option')
expect(selectOptions).toHaveLength(1)
expect(selectOptions[0]).toHaveTextContent('Item IV — Item A › Item 2')
await wrapper.events.click(wrapper.getByLabelText('Clear Search'))
expect(filterElement).toHaveValue('')
selectOptions = wrapper.getAllByRole('option')
expect(selectOptions).toHaveLength(3)
// Search for non-accented characters matches items with accents too.
await wrapper.events.type(filterElement, 'item c')
selectOptions = wrapper.getAllByRole('option')
expect(selectOptions).toHaveLength(1)
expect(selectOptions[0]).toHaveTextContent('Ítem C')
await wrapper.events.clear(filterElement)
selectOptions = wrapper.getAllByRole('option')
expect(selectOptions).toHaveLength(3)
// Search for accented characters matches items with accents too.
await wrapper.events.type(filterElement, 'ítem c')
selectOptions = wrapper.getAllByRole('option')
expect(selectOptions).toHaveLength(1)
expect(selectOptions[0]).toHaveTextContent('Ítem C')
await wrapper.events.clear(filterElement)
selectOptions = wrapper.getAllByRole('option')
expect(selectOptions).toHaveLength(3)
await wrapper.events.click(wrapper.getAllByRole('link')[0])
// With parent filtering, search happens only across children and other descendants.
await wrapper.events.type(filterElement, 'a')
selectOptions = wrapper.queryAllByRole('option')
expect(selectOptions).toHaveLength(0)
expect(wrapper.getByRole('alert')).toHaveTextContent('No results found')
await wrapper.events.clear(filterElement)
selectOptions = wrapper.getAllByRole('option')
expect(selectOptions).toHaveLength(3)
selectOptions.forEach((selectOption, index) => {
expect(selectOption).toHaveTextContent(
testOptions[0].children![index].label,
)
expect(selectOption).not.toHaveTextContent(`— ${testOptions[0].label}`)
})
// With parent filtering, search happens only across children and other descendants.
await wrapper.events.type(filterElement, 'III')
selectOptions = wrapper.getAllByRole('option')
expect(selectOptions).toHaveLength(1)
expect(selectOptions[0]).toHaveTextContent('Item III — Item A › Item 1')
await wrapper.rerender({ noFiltering: true })
expect(filterElement).not.toBeInTheDocument()
selectOptions = wrapper.getAllByRole('option')
expect(selectOptions).toHaveLength(3)
selectOptions.forEach((selectOption, index) => {
expect(selectOption).toHaveTextContent(
testOptions[0].children![index].label,
)
expect(selectOption).not.toHaveTextContent(`— ${testOptions[0].label}`)
})
})
})
describe('Form - Field - TreeSelect - Accessibility', () => {
it('supports element focusing', async () => {
const wrapper = renderComponent(FormKit, {
...wrapperParameters,
props: {
label: 'Select…',
type: 'treeselect',
options: testOptions,
clearable: true,
value: testOptions[0].value,
},
})
expect(wrapper.getByLabelText('Select…')).toHaveAttribute('tabindex', '0')
expect(wrapper.getByRole('button')).toHaveAttribute('tabindex', '0')
await wrapper.events.click(wrapper.getByLabelText('Select…'))
const selectOptions = wrapper.getAllByRole('option')
expect(selectOptions).toHaveLength(testOptions.length)
selectOptions.forEach((selectOption) => {
expect(selectOption).toHaveAttribute('tabindex', '0')
})
})
it('allows focusing of disabled field for a11y', async () => {
const wrapper = renderComponent(FormKit, {
...wrapperParameters,
props: {
label: 'Select…',
type: 'treeselect',
options: testOptions,
disabled: true,
},
})
expect(wrapper.getByLabelText('Select…')).toHaveAttribute('tabindex', '0')
})
it('restores focus on close', async () => {
const wrapper = renderComponent(FormKit, {
...wrapperParameters,
props: {
label: 'Select…',
type: 'treeselect',
options: testOptions,
disabled: false,
},
})
const selectButton = wrapper.getByLabelText('Select…')
await wrapper.events.click(selectButton)
expect(selectButton).not.toHaveFocus()
await wrapper.events.click(wrapper.getByRole('button', { name: 'Done' }))
expect(selectButton).toHaveFocus()
})
it("clicking disabled field doesn't select dialog", async () => {
const wrapper = renderComponent(FormKit, {
...wrapperParameters,
props: {
label: 'Select…',
type: 'treeselect',
options: testOptions,
disabled: true,
},
})
await wrapper.events.click(wrapper.getByLabelText('Select…'))
expect(wrapper.queryByRole('dialog')).not.toBeInTheDocument()
})
it("clicking select without options doesn't open select dialog", async () => {
const wrapper = renderComponent(FormKit, {
...wrapperParameters,
props: {
label: 'Select…',
type: 'treeselect',
options: [],
},
})
await wrapper.events.click(wrapper.getByLabelText('Select…'))
expect(wrapper.queryByRole('dialog')).not.toBeInTheDocument()
})
it('provides labels for screen readers', async () => {
const wrapper = renderComponent(FormKit, {
...wrapperParameters,
props: {
type: 'treeselect',
options: testOptions,
clearable: true,
value: testOptions[1].value,
},
})
expect(wrapper.getByRole('button')).toHaveAttribute(
'aria-label',
'Clear Selection',
)
})
it('supports keyboard navigation', async () => {
const wrapper = renderComponent(FormKit, {
...wrapperParameters,
props: {
label: 'Select…',
type: 'treeselect',
options: testOptions,
clearable: true,
value: testOptions[1].value,
},
})
await wrapper.events.type(wrapper.getByLabelText('Select…'), '{Space}')
const selectOptions = wrapper.getAllByRole('option')
wrapper.events.type(selectOptions[0], '{Space}')
await waitFor(() => {
expect(wrapper.emitted().inputRaw).toBeTruthy()
})
const emittedInput = wrapper.emitted().inputRaw as Array<Array<InputEvent>>
expect(emittedInput[0][0]).toBe(testOptions[0].value)
wrapper.events.type(wrapper.getByRole('button'), '{Space}')
await waitFor(() => {
expect(emittedInput[1][0]).toBe(null)
})
})
})
// Cover all use cases from the FormKit custom input checklist.
// More info here: https://formkit.com/advanced/custom-inputs#input-checklist
describe('Form - Field - TreeSelect - Input Checklist', () => {
it('implements input id attribute', async () => {
const wrapper = renderComponent(FormKit, {
...wrapperParameters,
props: {
id: 'test_id',
label: 'Test label',
type: 'treeselect',
options: testOptions,
},
})
expect(wrapper.getByLabelText('Test label')).toHaveAttribute(
'id',
'test_id',
)
})
it('implements input name', async () => {
const wrapper = renderComponent(FormKit, {
...wrapperParameters,
props: {
label: 'Select…',
name: 'test_name',
type: 'treeselect',
options: testOptions,
},
})
expect(wrapper.getByLabelText('Select…')).toHaveAttribute(
'name',
'test_name',
)
})
it('implements blur handler', async () => {
const blurHandler = vi.fn()
const wrapper = renderComponent(FormKit, {
...wrapperParameters,
props: {
label: 'Select…',
type: 'treeselect',
options: testOptions,
onBlur: blurHandler,
},
})
wrapper.getByLabelText('Select…').focus()
await wrapper.events.tab()
expect(blurHandler).toHaveBeenCalledOnce()
})
it('implements input handler', async () => {
const wrapper = renderComponent(FormKit, {
...wrapperParameters,
props: {
label: 'Select…',
type: 'treeselect',
options: testOptions,
clearable: true,
},
})
await wrapper.events.click(wrapper.getByLabelText('Select…'))
wrapper.events.click(wrapper.getAllByRole('option')[1])
await waitFor(() => {
expect(wrapper.emitted().inputRaw).toBeTruthy()
})
const emittedInput = wrapper.emitted().inputRaw as Array<Array<InputEvent>>
expect(emittedInput[0][0]).toBe(testOptions[1].value)
})
it.each([0, 1, 2])(
'implements input value display',
async (testOptionsIndex) => {
const testOption = testOptions[testOptionsIndex]
const wrapper = renderComponent(FormKit, {
...wrapperParameters,
props: {
label: 'Select…',
type: 'treeselect',
options: testOptions,
value: testOption.value,
},
})
expect(wrapper.getByRole('listitem')).toHaveTextContent(testOption.label)
},
)
it('implements disabled', async () => {
const wrapper = renderComponent(FormKit, {
...wrapperParameters,
props: {
label: 'Select…',
type: 'treeselect',
options: testOptions,
disabled: true,
},
})
expect(wrapper.getByLabelText('Select…')).toHaveClass(
'formkit-disabled:pointer-events-none',
)
})
it('implements attribute passthrough', async () => {
const wrapper = renderComponent(FormKit, {
...wrapperParameters,
props: {
label: 'Select…',
type: 'treeselect',
options: testOptions,
'test-attribute': 'test_value',
},
})
expect(wrapper.getByLabelText('Select…')).toHaveAttribute(
'test-attribute',
'test_value',
)
})
it('implements standardized classes', async () => {
const wrapper = renderComponent(FormKit, {
...wrapperParameters,
props: {
type: 'treeselect',
options: testOptions,
},
})
expect(wrapper.getByTestId('field-treeselect')).toHaveClass('formkit-input')
})
})
describe('Form - Field - TreeSelect - Visuals', () => {
it('arrow changes direction when locale changes', async () => {
const view = renderComponent(FormKit, {
...wrapperParameters,
props: {
type: 'treeselect',
options: testOptions,
},
})
expect(view.getByIconName('chevron-right')).toBeInTheDocument()
const locale = useLocaleStore()
locale.localeData = {
dir: EnumTextDirection.Rtl,
} as any
await expect(
view.findByIconName('chevron-left'),
).resolves.toBeInTheDocument()
})
it('back button arrow changes direction when locale changes', async () => {
const view = renderComponent(FormKit, {
...wrapperParameters,
props: {
label: 'Select…',
type: 'treeselect',
options: testOptions,
},
})
await view.events.click(view.getByLabelText('Select…'))
await view.events.click(view.getAllByIconName('chevron-right')[0])
expect(view.getByIconName('chevron-left')).toBeInTheDocument()
const locale = useLocaleStore()
locale.localeData = {
dir: EnumTextDirection.Rtl,
} as any
await expect(
view.findByIconName('chevron-right'),
).resolves.toBeInTheDocument()
})
})