select take options and not a boolean

to make it consistent with swipe component show function
add documentation