Tipo de pergunta - Texto livre longo
From LimeSurvey Manual
Descrição breve
Este tipo de pergunta coleta texto digitado em várias linhas.

Exemplo: Long_free_text_example.zip
Opções gerais
Obrigatória
Descrição
Esta opção permite que os administradores do inquérito exijam que os respondentes respondam a determinadas perguntas do inquérito. Se as perguntas obrigatórias não forem respondidas, os respondentes não poderão prosseguir. Se você tiver uma pergunta com várias subperguntas e precisar que apenas algumas delas sejam respondidas, use o atributo número mínimo de respostas localizado na aba Lógica.
Opções disponíveis
- Ativada (On) - A pergunta deve ser respondida antes que o participante possa prosseguir para a página seguinte - a opção de resposta 'Sem resposta' nunca é exibida.
- Suave (Soft) - Se a pergunta não for respondida, um aviso é exibido ao tentar prosseguir para a página seguinte - no entanto, o participante pode optar por ignorar o aviso e continuar. Observe que a opção 'Sem resposta' ainda é exibida (se ativada nas configurações de apresentação do questionário)
- Desativada (Off, padrão) - A pergunta pode ficar sem resposta
Condição
Descrição
Se o valor do resultado da condição for "1" ou "true", a pergunta é "relevante" no contexto do inquérito, ou seja, é exibida ao participante do inquérito. Caso contrário, a pergunta fica oculta. Qualquer pergunta do inquérito permite especificar uma equação de relevância. Esta função é a sucessora das condições e oferece suporte a uma lógica condicional muito mais complexa.
Realce de sintaxe
Sempre que você salva a condição, ela é avaliada e tem a sintaxe realçada. Os erros são codificados por cores para que você possa detectá-los e corrigi-los rapidamente.
Valores válidos
- Qualquer condição que use a sintaxe do ExpressionScript, sem chaves ao redor.
Exemplos
Aqui estão bons exemplos de realce de sintaxe.
Validação (usando expressões regulares) (preg_validation)
Descrição
Esta opção permite especificar uma expressão regular com a qual você pode validar todas as partes de uma pergunta.
Se qualquer valor de pergunta ou de pergunta secundária não atender aos requisitos de validação, a cor de fundo do campo de entrada de texto será alterada para vermelho, para que os participantes vejam facilmente quais partes da pergunta precisam ser corrigidas. Assim, você pode fazer a validação na própria página. Dessa forma, você não precisará esperar que o participante clique no botão de envio para validar a respectiva pergunta.
Valores válidos
- Qualquer expressão regular válida
Exemplo
- Clique aqui para ver vários exemplos.
Exibição
Exibir linhas (display_rows)
Descrição
Define o número de linhas exibidas sem a necessidade de usar a barra de rolagem para ver todo o conteúdo. Se houver mais linhas do que o número informado neste campo, uma barra de rolagem será exibida. O valor padrão para o tipo de pergunta "Texto livre longo" é 5, enquanto para o tipo de pergunta "Texto livre extenso" é 30.
Valores válidos
- Qualquer número inteiro positivo maior que 0
Ocultar dica (hide_tip)
Descrição
A maioria das perguntas geralmente inclui uma dica que diz "Selecione uma das opções a seguir" ou um texto de ajuda sobre como responder à pergunta. Este atributo permite ativar ou desativar essas dicas.
Essas dicas incluem mensagens de critérios de validação (como número mínimo/máximo de respostas ou valor mínimo/máximo/Igual à soma). Se hide_tip estiver ativado, essas mensagens ficarão ocultas. No entanto, se o usuário inserir dados inválidos, as dicas serão exibidas. Elas aparecerão em vermelho e mudarão para verde assim que os critérios de validação forem atendidos.
Opções disponíveis
- Ativado - as dicas ficam ocultas;
- Desativado (padrão).
Largura da caixa de entrada (text_input_width)
Descrição
Este atributo define a largura das caixas de entrada de texto (do "wrapper" das caixas de entrada de texto). A caixa de entrada é usada para inserir uma resposta à pergunta (ou pergunta secundária). Se o valor da largura for suficientemente alto, a caixa de entrada de texto será exibida na linha seguinte. Observe que esta opção não define o tamanho da entrada nem a largura da coluna inteira!
Opções disponíveis
- Padrão: se selecionado, um valor padrão será atribuído a este atributo de modo que tanto o rótulo quanto a caixa de entrada de texto correspondente fiquem na mesma linha. Por exemplo, se a largura da caixa de entrada de texto for 41%, o valor da largura da caixa de entrada de texto será um valor que permita o rótulo e a caixa de entrada na mesma linha (58% neste caso). Se a largura da caixa de entrada de texto fosse maior que 58%, a caixa de entrada de texto seria exibida na linha seguinte.
- 8%; 17%...92%, 100%: quanto maior o valor selecionado, maior a largura da caixa de entrada de texto.
Exemplo
- Se você deseja que a parte de entrada seja exibida abaixo da pergunta secundária/rótulo, selecione a opção 100% na lista suspensa.
Tamanho da caixa de entrada de texto (input_box_size)
Descrição
Esta função permite definir o tamanho da área de texto (a caixa de entrada de texto). Por padrão, o LimeSurvey força a exibição da caixa de entrada com um tamanho padrão. Isso pode ser substituído com o uso desta função.
Valores válidos
- Qualquer valor numérico
Tema da questão (question_theme)
Descrição
Permite usar temas personalizados para a respectiva pergunta.
Opções disponíveis
- Os temas de perguntas criados por você, que estão localizados em Temas de perguntas no painel Temas.
Veja: Temas de perguntas
Descrição
Se ativada, a pergunta sempre ficará oculta - ela não será exibida aos participantes do questionário. Esta função pode ser usada nos seguintes cenários:
- Se você deseja preencher previamente uma pergunta por meio de uma URL e não quer que ela seja exibida na tela. Isso substitui quaisquer condições usadas no inquérito, pois a respectiva pergunta nem sequer será incorporada à página.
- Se você deseja armazenar ou calcular um valor dinamicamente por meio do ExpressionScript.
Opções disponíveis
- Ligado
- Desligado (padrão)
Classe CSS (css_class)
Descrição
Se você quiser adicionar classes CSS especiais a determinadas perguntas, insira o(s) nome(s) da classe CSS neste campo. Certifique-se de deixar um espaço em branco entre os diferentes nomes de classe.
Valores válidos
- Qualquer cadeia de texto com um espaço entre os diferentes nomes de classes CSS.
Entrada
Máximo de caracteres (maximum_chars)
Descrição
Permite definir o número máximo de caracteres que podem ser inseridos em uma pergunta baseada em texto. Inserir um valor de, por exemplo, 20 significa que o participante não poderá digitar mais de 20 caracteres.
Valores válidos
- Qualquer valor inteiro acima de 0
Lógica
Nome do grupo de randomização (random_group)
Descrição
Coloca as perguntas em um grupo de randomização específico. Todas as perguntas incluídas no grupo especificado são exibidas em ordem aleatória para os respondentes do inquérito.
Você pode encontrar um inquérito de exemplo que usa o nome do grupo de randomização em inquérito de exemplo do ExpressionScript.
Valores válidos
Basta inserir qualquer texto de sua preferência (por exemplo: 'group1'). Todas as perguntas que tiverem o mesmo texto definido na caixa Nome do grupo de randomização terão sua posição no inquérito randomizada (=trocada aleatoriamente entre si).
Pre-visualização
Para pré-visualizar as perguntas, use a função Visualizar questionário em vez de Pré-visualizar o grupo de perguntas, pois há relatos de que esta última não exibe as perguntas em ordem randomizada.
Fórmula de validação da pergunta (em_validation_q)
Descrição
Esta é uma fórmula usada para validar a pergunta inteira (por exemplo, todas as suas partes em conjunto, no caso de uma pergunta de múltiplas respostas). Se a pergunta não atender aos critérios de validação, a mensagem em_validation_q_tip será exibida (ela usa o estilo CSS .error). Esta dica usa o estilo CSS .em_q_fn_validation, que fica oculto por padrão em template.css.
A principal diferença entre este recurso e as fórmulas de validação de pergunta secundária (opção em_validation_sq) é que, neste recurso, se a pergunta (ou partes dela) falhar na validação, uma mensagem de erro pode ser exibida. Na validação de pergunta secundária, cada célula de entrada de texto (por exemplo, em um tipo de pergunta de array, mas também pode ser aplicada a tipos de pergunta de entrada única) receberá um estilo em que a cor de fundo fica vermelha (clara).
Valores válidos
- Qualquer fórmula que use a sintaxe do ExpressionScript, sem chaves ao redor.
Exemplo
- Você deseja coletar informações demográficas dos usuários por meio de uma pergunta de Texto curto múltiplo e deseja validar se o usuário informou um e-mail e um número de telefone válidos.
Este exemplo mostra como a pergunta aparece com respostas inválidas:

E aqui está como ela aparece com uma resposta inválida:

Veja como editar uma pergunta para inserir essas informações:

E aqui está parte da saída do arquivo Show Logic, que permite verificar a precisão da sua expressão e garantir que não haja erros de sintaxe:

Como você pode ver, a fórmula de validação testa se o e-mail e o número de telefone estão vazios ou correspondem a um filtro de expressão regular.
A dica de validação só exibe a mensagem de aviso se o telefone ou o e-mail parecer inválido.
Se quiser importar o exemplo acima para a sua instalação do LimeSurvey, baixe o seguinte arquivo .lsq: Em_validation_q_example.zip.
Dica para a fórmula de validação da pergunta inteira (em_validation_q_tip)
Descrição
Se você estiver usando a fórmula de validação da pergunta, pode usar esta caixa para exibir uma mensagem opcional como dica da pergunta sobre como ela deve ser preenchida.
Valores válidos
- Qualquer texto ou fórmula que use a sintaxe do ExpressionScript.
Exemplo
Veja o exemplo na seção da wiki sobre a fórmula de validação da pergunta. Ele mostra como a dica pode ser adaptada para indicar quais partes de uma pergunta do tipo Texto curto múltiplo não atendem aos critérios de validação.
Fórmula de validação da pergunta secundária (em_validation_sq)
Descrição
Esta é uma fórmula usada para validar cada pergunta secundária (campo de texto) individualmente. Qualquer campo de texto que não atenda a essas condições de validação terá a cor de fundo alterada para rosa (usando o estilo CSS .em_sq_fn_validation) para destacar o erro. Observe que essa opção está disponível além da opção de validação baseada em expressão regular.
Valores válidos
Qualquer fórmula que use a sintaxe do ExpressionScript, sem chaves ao redor.
Exemplos
Por exemplo, se você quiser permitir como respostas apenas números que sejam múltiplos de 3, a fórmula seria:
(this / 3) == floor(this/3)
A variável reservada this é substituída automaticamente por uma referência à célula de entrada de texto ativa.
Dica para a fórmula de validação de subpergunta (em_validation_sq_tip)
Descrição
Se você estiver usando em_validation_sq, esta é uma mensagem/dica opcional que será exibida se a resposta informada estiver incorreta.
Valores válidos
- Qualquer texto
Exemplo
- Continuando o exemplo de validação de e-mails, a dica pode ser "Insira endereços de e-mail válidos."
Outros
Inserir quebra de página na visualização para impressão (page_break)
Descrição
Este atributo só fica ativo quando você realmente imprime um inquérito a partir da Visualização para impressão. Ele força uma quebra de página antes da pergunta.
Opções disponíveis
- Ligado
- Desligado (padrão)
Estatísticas
Exibir gráfico (display_chart)
Descrição
Este atributo permite que o administrador do inquérito escolha se um gráfico com os resultados da pergunta deve ser exibido aos participantes do questionário após eles preencherem o inquérito.
- Configuração de inquérito Estatísticas públicas em Configurações de apresentação e navegação
- Configuração de inquérito Mostrar gráficos em Configurações de apresentação e navegação
- Atributo de pergunta Estatísticas públicas e
- atributo de pergunta Exibir gráfico.
Opções disponíveis
- Ativado
- Desativado (padrão)
Tipo de gráfico (chart_type)
Descrição
Este atributo permite que o administrador do inquérito escolha qual tipo de gráfico será exibido ao respondente após ele concluir o preenchimento do inquérito.
Opções disponíveis
- Gráfico de barra
- Gráfico de pizza
- Radar
- Linha
- Área polar
- Rosca
Temporizador
Limite de tempo (time_limit)
Descrição
Definir o atributo time_limit em uma pergunta faz com que um cronômetro regressivo comece a contar assim que essa pergunta/página for carregada. Quando o cronômetro chegar a zero, a pergunta avançará automaticamente para a Página seguinte ou passará a ser somente leitura.
Valores válidos
- Qualquer número inteiro positivo
Exemplo
Defina como 240 para fazer uma contagem regressiva de 4 minutos (240 segundos).
<onlyinclude>
Ação de limite de tempo (time_limit_action)
Descrição
Define a ação executada quando um time_limit expira. Por padrão, a ação para um limite de tempo é "Alertar e prosseguir", o que significa que o sistema exibirá um breve aviso de que o limite de tempo expirou antes de salvar a pergunta e, na prática, clicar automaticamente em "Próximo >>". As demais opções são:
- "Prosseguir sem advertência", que clica automaticamente no botão "Próximo >>" após o término do cronômetro, mas sem nenhuma mensagem de aviso.
- "Desabilitar apenas", que desabilita alterações na pergunta para que o participante não possa alterar nada, mas não clica automaticamente no botão "Próximo >>".
Esta configuração só se aplica se a configuração geral de limite de tempo estiver ativada.
Opções disponíveis
- Alertar e prosseguir (padrão): avisa o participante de que o tempo expirou e, em seguida, clica no botão de avançar
- Prosseguir sem advertência: clica imediatamente no botão de avançar após o limite de tempo expirar
- Desabilitar apenas: desabilita a resposta após o limite de tempo expirar, mas não clica automaticamente em avançar
Informações adicionais
Em vez de depender de perguntas obrigatórias, você pode usar expressões (saiba mais sobre as equações de validação de pergunta e de pergunta secundária) para evitar que o usuário deixe os campos de resposta vazios. Para ver como as equações de validação funcionam, consulte o seguinte exemplo.
Caso deseje aplicar um cronômetro a um grupo de perguntas, ative o modo de inquérito grupo a grupo, configure uma pergunta para usar a funcionalidade de limite de tempo e escolha a opção Alertar e prosseguir (padrão) como ação de limite de tempo. Quando o cronômetro da pergunta expirar, o inquérito passará para a página seguinte.
Questionário próximo a ser desabilitado por limite de tempo (time_limit_disable_next)
Descrição
Permite desabilitar o botão "Próximo" enquanto uma contagem regressiva de time_limit está em andamento. Normalmente, mesmo com a contagem regressiva do limite de tempo ativa, se o participante quiser clicar em "Próximo" e avançar para a próxima pergunta ou grupo de questões, basta clicar no botão "Próximo" (reduzindo, assim, o tempo gasto na pergunta ou no grupo de questões). Ao ativar esta função, o botão Próximo aparecerá esmaecido e não ficará disponível até que o cronômetro termine a contagem regressiva.
Esta configuração só se aplica se a configuração geral de limite de tempo estiver ativada.
Opções disponíveis
- Ligado - O botão "Próximo" ficará desabilitado até que a contagem regressiva do limite de tempo termine.
- Desligado (padrão)
Limite de tempo desabilita o anterior (time_limit_disable_prev)
Descrição
Permite desabilitar o botão "Anterior" enquanto uma contagem regressiva de time_limit está em andamento. Normalmente, mesmo que a contagem regressiva do limite de tempo esteja ativa, se o participante quiser clicar em "Anterior" e voltar à pergunta ou ao grupo de questões anterior, basta clicar no botão "Anterior" (reduzindo, assim, o tempo gasto na pergunta ou no grupo de questões). Ao ativar esta função, o botão Anterior aparecerá esmaecido e não estará disponível até que a contagem regressiva termine.
Esta configuração só se aplica se a configuração geral de Limite de tempo estiver ativada.
Opções disponíveis
- Ligado - o botão "Anterior" ficará desabilitado até que a contagem regressiva do limite de tempo termine.
- Desligado (padrão)
Mensagem de contagem regressiva do limite de tempo (time_limit_countdown_message)
Descrição
Escreva neste campo a mensagem de texto que deseja exibir no cronômetro de contagem regressiva durante a contagem. Esta configuração só se aplica se a configuração geral de limite de tempo estiver ativada. Se nada for escrito, o campo usará o valor padrão: "Tempo restante".
Estilo CSS do cronômetro do limite de tempo (time_limit_timer_style)
Descrição
Permite definir (e substitui o padrão) o estilo CSS usado para exibir o cronômetro regressivo. Se este atributo não existir, será usado o valor de estilo padrão, que é: 'width: 150px; margin-left: auto; margin-right: auto; border: 1px solid #111; text-align: center; background-color: #EEE; margin-bottom: 5px; font-size: 8pt;'.
Qualquer texto inserido neste atributo substituirá todo o estilo CSS padrão, portanto, tenha cuidado ao informar um valor para ele. Uma maneira simples de ocultar o cronômetro é copiar o estilo padrão para este atributo e adicionar 'display: none;' ao final.
Esta configuração só se aplica se a configuração geral de limite de tempo estiver ativada.
Tempo de apresentação da mensagem de expiração do limite de tempo (time_limit_message_delay)
Descrição
Este atributo define por quantos segundos a time_limit_message é exibida antes de a time_limit_action ocorrer. Se este atributo não for definido, o valor padrão será 1 (1 segundo).
Esta configuração só se aplica se as configurações gerais de limite de tempo estiverem ativadas.
Exemplo
time_limit_message_delay: 5 = a mensagem é exibida por 5 segundos
Mensagem de expiração do limite de tempo (time_limit_message)
Descrição
Este é o texto da mensagem exibida ao participante quando o time_limit expira. Por padrão, esta mensagem é "Seu tempo para responder esta questão expirou". Se o atributo time_limit_action estiver definido como "Prosseguir sem advertência", esta mensagem não será exibida. Você pode definir o estilo CSS deste texto no atributo time_limit_message_style (veja abaixo).
Esta configuração só é aplicável se as configurações gerais de limite de tempo estiverem ativadas.
Exemplo
time_limit_message: O limite de tempo para responder a esta pergunta acabou.
Estilo CSS da mensagem de limite de tempo (time_limit_message_style)
Descrição
Permite definir (e substituir o padrão) o estilo CSS usado para exibir a mensagem de limite de tempo. Se o atributo não existir, será usado o valor de estilo padrão, que é: 'top: 10px; left: 35%; width: 30%; height: 60px; padding: 16px; border: 8px solid #555; background-color: white; z-index: 1002; text-align: center; overflow: auto'.
Qualquer texto inserido neste atributo substituirá todo o estilo CSS padrão, portanto, tenha cuidado ao informar um valor para este atributo. É altamente recomendável reutilizar o valor de z-index ou, pelo menos, garantir que o valor de z-index seja maior que o usado no atributo time_limit_warning_message_style (cujo padrão é 1001).
Exemplo
Defina como: top: 10px; left: 35%; width: 30%; height: 60px; padding: 16px; border: 8px solid #555; background-color: black; color: white; z-index: 1010; text-align: center; overflow: auto
Temporizador da mensagem de aviso de limite de tempo (time_limit_warning)
Descrição
Com a ajuda deste atributo, você pode definir o tempo (em segundos) antes do término do limite de tempo em que a time_limit_warning_message será exibida. Definir um valor para este atributo ativa a mensagem de aviso de limite de tempo.
Esta configuração só é aplicável se a configuração geral de limite de tempo estiver ativada. Esta configuração também existe para uma segunda mensagem de aviso.
Exemplo
Se você definir este valor como '20', a mensagem de aviso de limite de tempo aparecerá 20 segundos antes de a contagem regressiva do limite de tempo chegar a zero.
Tempo de exibição da mensagem de aviso de limite de tempo (time_limit_warning_display_time)
Descrição
Define por quanto tempo a time_limit_warning_message é exibida antes de ser removida/ocultada da tela. Por padrão, se a time_limit_warning_message aparecer, ela permanecerá visível até que o cronômetro regressivo termine a contagem. Se um valor maior que zero for informado neste campo, a mensagem será ocultada após essa quantidade de segundos.
Esta configuração só é aplicável se a configuração geral de limite de tempo estiver ativada. Essa configuração também existe para uma segunda mensagem de aviso.
Exemplo
time_limit_warning_display_time: 10 = A mensagem de aviso de limite de tempo desaparecerá 10 segundos após o momento em que aparecer.
Mensagem de aviso de limite de tempo (time_limit_warning_message)
Descrição
Se configurada, exibe o texto da mensagem de aviso que é mostrada por um período fixo de tempo antes de um limite de tempo expirar. O texto padrão é "Seu tempo para responder a esta pergunta está quase esgotado. Restam {TIME}." {TIME} é substituído por uma descrição formatada que representa o tempo restante (por exemplo, "30 segundos", "1 minuto ou 5 segundos"). Esta mensagem só aparece se o atributo time_limit_warning existir. Você pode definir, a partir do atributo time_limit_warning, quando a mensagem (time_limit_warning_message) aparece.
Este atributo de pergunta só é aplicável se a configuração de limite de tempo estiver ativada e você definir algum texto no campo mensagem de aviso de limite de tempo. Esta configuração também existe para uma segunda mensagem de aviso.
Exemplo
Atenção: em {TIME} o limite de tempo para responder a pergunta irá expirar.
Estilo CSS do aviso de limite de tempo (time_limit_warning_style)
Descrição
Permite definir (e substitui o padrão) o estilo CSS usado para exibir a mensagem de aviso de limite de tempo. Se o atributo não existir, será usado o valor de estilo padrão, que é: 'top: 10px; left: 35%; width: 30%; height: 60px; padding: 16px; border: 8px solid #555; background-color: white; z-index: 1001; text-align: center; overflow: auto'.
Qualquer texto inserido neste atributo substituirá todo o estilo CSS padrão da mensagem de aviso, portanto, tenha cuidado ao informar um valor para este atributo. Recomenda-se fortemente reutilizar o valor de z-index ou, pelo menos, que o valor de z-index seja menor que o usado no atributo time_limit_message_style (cujo padrão é 1002).
Esta configuração só se aplica se a configuração geral de limite de tempo estiver ativada. Esta configuração também existe para uma segunda mensagem de aviso.
Exemplo
top: 10px; left: 35%; width: 30%; height: 60px; padding: 16px; border: 8px solid #555; background-color: gray; color: white; z-index: 1001; text-align: center; overflow: auto